MoveWindowStructure

Positions a window relative to its structure region.

pascal OSStatus MoveWindowStructure (
                     WindowPtr window,
                     short hGlobal,
                     short vGlobal);

window

A value of type WindowPtr . Pass a pointer to the window to be moved.

hGlobal

Pass a value specifying the horizontal position, in global coordinates, to which the left edge of the window's structure region is to be moved.

vGlobal

Pass a value specifying the vertical position, in global coordinates, to which the top edge of the window's structure region is to be moved.

function result

A result code. See Result Codes.

DISCUSSION

The MoveWindowStructure function moves the specified window, but does not change the window's size. When your application calls MoveWindowStructure , the positioning of the specified window is determined by the positioning of its structure region. This is in contrast to the MoveWindow function, where the positioning of the window's content region determines the positioning of the window. After moving the window, MoveWindowStructure displays the window in its new position.

Note that your application should not call the MoveWindowStructure function to position a window when the user drags the window by its drag region. When the user drags the window, your application should call the pre-Mac OS 8.5 Window Manager function DragWindow .

VERSION NOTES

Available with Mac OS 8.5 and later.